Developer(s) | Simon Marlow |
---|---|
Initial release | May 1, 2002 |
Stable release | 2.8.0 / September 2, 2010 |
Written in | Haskell |
Operating system | Cross-platform |
Platform | x86, PowerPC |
Type | Documentation generation |
License | BSD-style license |
Website | http://haskell.org/haddock/ |
Haddock is a free, portable[1] command-line program documentation generator for Haskell. It is influenced by IDoc [1], HDoc [2], and Doxygen.[2] It produces hyperlinked HTML files from annotated Haskell (the documentation is embedded in comments) source files, with additional information extracted from type annotations; it supports only partially generating documentation in SGML.[3] It is often used in conjunction with darcs and Cabal. It is dependent on GHC, using a modified form of the HsParser (written in Happy) parser for Haskell included in GHC.[3] Its lightweight markup is based on IDoc's.[3] The entire implementation is approximately 2200 lines of code.[3] Haddock is contained in the Haskell Platform.
It is used by the GHC, Gtk2Hs and HTk projects,[4] as well as XMonad and Yi.
Here is an example of Haddock markup:
-- | This is the documentation for 'square', which -- uses the (*) operator from "Prelude". -- It multiplies the @x@ argument against itself. square :: Integer -> Integer square x = x*x